EasyFind 3.8.1
    ©2001-2005 Christian Grunenberg, DEVONtechnologies LLC
    Icon by Martin Libich (mlib@mac.com)
    Japanese localization by Hiroto Sakai (sakai@fan.gr.jp)

    EasyFind is an alternative to or supplement of Sherlock and finds files, folders or contents in any file without the need
    for indexing - and therefore immediately! This is especially useful if you are tired of slow or impossible indexing, 
    outdated or corrupted indexes or if you are just looking for missing features like case sensitive or insensitive search,
    boolean operators and wildcards or searching for phrases. In addition EasyFind uses multithreading and is therefore
    very responsive even with multiple search processes running, provides contextual menus & services and displays the 
    location of each item in a separate column for a better overview. Finally EasyFind uses little memory, supports drag & 
    drop and the clipboard and finds optionally invisible items or items within packages.

    Licence:
    This software and associated data are provided "as is" without any further warranties or support and to be 
    used at your own risk. No responsibility is taken for the use or misuse of this software, the data supplied with it 
    and for the correctness of any information derived from the use of this software.
    Unmodified redistribution of this software is permitted.

    Installation:
	Copy EasyFind into the applications-folder or whereever you like if you don't need services. To activate
	services log out and log in again after you have started EasyFind at least once.

    System requirements:
	• Mac OS X 10.3 (or newer)

    Usage:
	Start EasyFind using the Finder or the Services-menu ("EasyFind/Find In Path..." and "EasyFind/Find Selection..."-
	items) within Cocoa-applications or Carbon-applications supporting services, enter your keywords, select the 
	desired volume or folder and press the Return or Enter key or click on the search button . You may also open 
	additional search windows in the meantime and run multiple processes at once or stop the currently running search 
	(once you've started a search, the "Search"-button becomes a "Stop"-button until the process has finished)

	EasyFind displays all found items immediately so it's possible to drag & drop an item (e.g. onto Finder windows, 
	the dock or other applications) even while the search is going on (vertical motion begins a multiple file selection, 
	horizontal motion starts drag & drop). Or select "Open" in the "File"-menu to open one or more files with the 
	appropriate application (or just double click on them), "Reveal In Finder" to open the enclosing folder in the Finder, 
	"Destroy" to delete the items (after a warning) immediately, "Move To Trash" to trash them (without a warning) or
	"Show Info" to display the info panel of the Finder for the selected items. You may also use contextual menus by 
	right- or control-clicking on selected items to perform these actions.

    Speed:
            The speed compared to Sherlock (or Jaguar's & Panther's Finder) varies - the more results you get and the smaller
	the folders you're searching in are, the faster is EasyFind (up to 5 times faster). But searching in whole volumes 
	may be about 5 times slower than Apples solution as EasyFind is "really" searching (the speed is comparable to the 
	Unix-tool "find" but EasyFind doesn't use this). If you want to do your own benchmarks, use the options to 
	"Files & Folders", "Phrase" and "Case insensitive" to get comparable results.

	If you're searching for contents, the ratio depends on your set of activated file extensions & HFS types and the 
	number of files matching these criteria. And you have to consider the time Sherlock (and other solutions based on 
	indexing or databases) needs for creating and updating indexes.

	Finally by using the "Or"-operator it's possible to combine multiple searches and therefore reduce the duration.

    Options:
	• Select the folder or volume to search in:
	  This popup includes all mounted volumes, all visible folders within the root-directory ("/"), within your home
	  directory, on your desktop, your favorites and all folders inside the directory "~/Library/EasyFind". EasyFind 
	  resolves aliases while initializing this menu (but not while searching) and automatically removes duplicate folders. 
	  If you want to extend this menu, just add or remove items to your favorites ("~/Library/Favorites") or to 
	  EasyFind's user-defined directory ("~/Library/EasyFind"). Or use the "Select..." command to specify any folder.
	• Look for file & folder names, only file names, only folder names or file contents
	• Find files with all keywords ("All Words"), with at least one keyword ("Any Word") or find exact phrases
	  ("Phrase"), use wildcards (including prefixes and suffixes) or operators.
	  
	  Wildcards:

		*		multiple characters
		[a-b]		range of characters
		[a|b|c|...] or	choice of characters
		[abc...]	
		[^...]		exclude characters
		?		any character

		Example:	Result:
		Demo* 	→ everything starting with "Demo" (Prefix)
		*ing		→ everything ending with "ing" (Suffix)
		NS*.h		→ everything starting with "NS" and ending with ".h" (e.g. all Cocoa header files)
		?ouse		→ all words with 5 characters and ending with "ouse" (e.g. "mouse" or "house")
		[a-ez]*		→ everything starting with a, b, c, d, e or z
		[d-fk-j]*[gh]	→ everything starting with d, e, f, k, i or j and ending with g or h
		[^be]*		→ everything not starting with b or e

	  Operators: (syntax is identical to the one of DEVONagent)

		AND / BUT / + / &	And
		OR / |			Or
		NOT / - / !		Not
		~			Proximity to match partial words/substrings too (otherwise only complete
					words are accepted)
		XOR / EOR / ^	Exclusive Or
		NEAR	
		NEAR/n		
		AFTER / BEFORE
		()			Parenthesis
		""			Phrases

	• Case insensitive search
	• Find also invisible files and folders
	• Include package contents in search
	• Sort by name, date, size or location (ascending and descending)
	
    Settings for content searching:
	Define or turn on and off up to 5 different lists of file extensions & HFS types (usually only plain text files, each
	extension or HFS type separated by commatas, HFS types within single quotes like 'TEXT') used for content 
	searching. As EasyFind uses no indexing this is necessary to improve performance but it's also possible to scan
	all files.

    Tips & Tricks:
	• You can copy selected results to the pasteboard and insert them in other applications (e.g. TextEdit)  
	• Size and order of columns, sorting of results and size of windows are all persistent (for each window on its own)
	• To copy selected results to a particular folder, drag the results from EasyFind to the Finder.
	• To move selected results to a particular folder, drag the results from EasyFind to the Finder while pressing the
	  Command key
	• To create aliases of selected results, drag the results from EasyFind to the Finder while pressing the
	  Command and Option keys
	• Pressing Command-. cancels a running search too

    Customization:

	If you want to remove unnecessary services or change the menus or shortcuts, you
	have to edit the file "info.plist" within the EasyFind-package (use contextual menus
	in the Finder to show the contents).

		- Delete elements of the array "NSServices" to remove unnecessary services
		- Change the "default"-element of "NSKeyEquivalent"-dictionaries to adapt
		  shortcuts
		- Change the "default"-element of "NSMenuItem"-dictionaries to adapt the
		  name or structure of menu-items

    History:	
	• Version 3.8.1:
		- Up to 2.3 times faster searching for files and/or folders
		- Improved French localization
		     - Tooltips display full path instead of relative path for location column
		     - EasyFind doesn't add the "Temporary Items" folder of the startup volume to its popup menu anymore
		     - Dynamic updating of „Open with“ menu could cause delays after certain keystrokes. Fixed.
	• Version 3.8:
		- "Open with" submenu added (similar to the Finder)
		- Support for DEVONthink Personal removed
		- Wildcards ending with „word*“ did not accept contents ending with word. Fixed.
	• Version 3.7.1:
		     - Handling of tooltips in results view optimized for Mac OS X 10.4.x „Tiger“
		     - Clicking on a results column did not immediately sort the list. Fixed.
	• Version 3.7:
		- New "Type" column to find window added
		- "Add to DEVONthink (Pro)" menu items are disabled/removed from contextual menus
		  if DEVONthink PE/Pro are not available.
		- EasyFind froze after deleting results or moving them to the trash. Fixed.
		- Minor user interface changes & fixes
	• Version 3.6:
		- Possibility to scan all, local or removable volumes to search pop up menu added
		- General performance improvements, e.g. of internal bulk searching and wildcard matching
		- Improved sorting by path
		- Several bugs of matching wildcards containing ranges or choices of characters
		- Links in "About" panel are clickable
		- Improved stability (especially when scanning contents of all files)
	• Version 3.5:
		- As the wildcard support of Apple's Cocoa frameworks is still not reliable, EasyFind
		  now uses its own (and up to 4 times faster) implementation to match wildcards
		- Unix wildcards specifying or excluding a range or choice of characters ([...]) are supported
		- Tooltips display the full path & filename of found files/folders
		- Searching for files and/or folders was not possible if file extensions and types for content
		  searching were undefined/unchecked and "Scan All" disabled too. Fixed.
	• Version 3.4.1:
		- Striped rows of results view
		- Redraw glitch after resizing columns or windows fixed
		- Pressing page up/down in results view did not work
		     - Faster drawing of results view
	• Version 3.4:
		- Dragging found files/folders to the Finder or desktop moves the items instead of copying them. To copy
		  or alias the items, press the Option or Command-Option modifier keys.
		     - EasyFind supports syntax of operators used by Finder/Spotlight (!, ^, & and |) too
		- Faster drawing of list of results
		- Reduced memory usage of list of results
		- More reliable "Check for updates" command
		- Minor memory leak fixed
	• Version 3.3.1:
		- More stable and faster scanning of filesystem supports up to 100 nested folders (recommended limit 
		  of HFS+ filesystems)
		- Faster drawing of results list
	• Version 3.3:
		- EasyFind adds folders/aliases inside the directory "~/Library/EasyFind" (automatically created after
		  launching if necessary) to the top of the directory popup (below all mounted volumes) and therefore 
		  it's not necessary anymore to add all your personal folders to the favorites.
		- New command "Add to DEVONthink Pro" (public beta will be released soon)
		- Rastered resizing of search windows
		- Minor optimizations
		- French localization by Hervé Roth
		- Minor glitches of English/Japanese/German localizations fixed
	• Version 3.2:
		     - New proximity operator ~ to match partial words/substrings too (by default only complete
		       words are accepted)
		- Directory popup displays icons for each item
		- "Select..." command moved to the top of the directory popup
		- Shortcuts to "Destroy", "Move To Trash" and "Select..." commands added
		- Input field has the focus right after opening windows or launching the application
		- Pressing Command-. cancels a running search too
		- Closing the settings drawer automatically resizes/moves the window to the previous frame
		  if the window has been resized/moved while opening the drawer
		- Home/Begin/End function keys select the first/last result
		- Files and files packages (e.g. on the desktop) aren't added to the path popup anymore
	• Version 3.1:
		- Directory popup provides "Select..." command to select any folder to scan
		  and uses localized names
		- If the option "Scan all files" is active, the file extension fields/buttons are disabled
		- Japanese localization of services fixed
	• Version 3.0:
		- New search mode "Operators" to use AND/OR/XOR/NEAR/AFTER/BEFORE operators
		  and parenthesis or phrases (syntax is identical to the one of DEVONagent)
		- New drawer containing settings for content searching (instead of previous preferences panel)		- New preference to quit EasyFind when last window is closed
	- Folders and aliases of desktop are added to directory popup
	- Directory popup displays real name of startup disk
	- "And"/"Or" search modes renamed to "All Words"/"Any Word"
	- Slightly improved performance
	- Updated Japanese localization
	- Revised documentation
	• Version 2.8.2:
		- New "Check for Updates" command
		- Sorting by name ignores umlauts
		- Some performance improvements of file/folder search (especially if you're searching more than
		  once in the same directories)
		- Compiled using GCC 3.3
		- Minor modifications of user interface
	• Version 2.8.1:
		- Clicking on column headers changes sorting
		- EasyFind remembers if sorting was reverse
		- Some rare crashs fixed
	• Version 2.8:
		- New preference to scan all file contents regardless of file extension or HFS type
		- New option to search only for folders
		- New sort "by Kind" option
	- Contextual menus only contain enabled items/submenus (according to
	  Apple's Human Interface Guidelines)
		- Closing the preferences panel did not apply new settings
	• Version 2.7:
		- New "Add To DEVONthink" command imports selected results into the database
		  of DEVONthink
		- Updated Japanese localization
		- Icon for document packages (like "RTFD") was usually a folder icon
	• Version 2.6:
		- German localization
		- New "Show Info" command (displays info panel of Finder for selected items)
		  (requires Mac OS X 10.2)
		- Improved dragging of results (e.g. on Dock or to Finder)
		- Sorting recognizes numbers in file names and treats them accordingly
		- Lots of new default file extensions & HFS types (delete old preferences if necessary)
		- EasyFind remembers the position of the windows without the need to resize windows
		- Uniform display of Size column in KB
		- Localized date & time display
		- Location ("Where" column) is abbreviated if necessary (relative to search path)
		- Shortcuts for "Hide others" and "Preferences" added
		- "Zoom Window" menu item added
		- Rounded search field & spinning search indicator under Mac OS X 10.2
		- Renamed service localizations from "servicesMenu.strings" to "ServicesMenu.strings"
		  (fixes problems under Mac OS X 10.2)
		- Fixed services declaration
		- Deleting files threw exceptions under some circumstances
		- Aliases & Symlinks (e.g. in home or favorites directory) are not resolved during startup
		  (and while building the popup menu) anymore. Instead selected items will be resolved only
		  if necessary. This should fix the problem that aliases to unmounted servers did cause long
		  delays.
		- Minor GUI glitches fixed
	• Version 2.5:
		- Japanese localization by Hiroto Sakai (sakai@fan.gr.jp)
		- Support of wildcards (* and ?) (e.g. useful to look for a certain prefix or suffix)
		- Sort results by name, date, size or location (ascending or descending)
		- Visible folders of root-directory ("/") are included in the popup-menu
		- Clicking on the dock icon opens a new window if none is visible
		- 'ttro'- and 'sEXT'-HFS file types to default preferences added
		- Faster scrolling & sorting
		- While a destroy-warning is visible, the list of results is locked to avoid changing selections
		- Invisible "automount"-folder wasn't treated correctly
	• Version 2.0:
		- Icon by Martin Libich (mlib@mac.com)
		- Definition of HFS file types for content searching is possible (e.g. 'TEXT'')
		- Copy selected results to the pasteboard to insert them afters in other applications (e.g. TextEdit)
		- Support of find-pasteboard
		- In addition to the number of items found EasyFind displays also the number of items already done
		- The path of items located in the home-directory is abbreviated
		- The list of results takes into account if a file extension should be displayed or not and
		  displays generic icons
		- Additional default file-extensions/types (cp, mm, java, readme, rtf, sgm, sgml, plist, 'TEXT')
		- If the "Invisible Files & Folders"-option was set and the startup disk selected, EasyFind did
		  sometimes search within all volumes
		- The list of results wasn't always up to date while the program was searching
		- Minor memory leaks fixed
		- Recompiled using the Mac OS X 10.1-developer tools with maximal
		  optimization and no debugging symbols (faster and smaller code)
		- Readme explains how to customize the services-menu
	• Version 1.0:
		- Initial release

    Christian Grunenberg
    mailto:christian@grunenberg.com
    http://www.grunenberg.com

    DEVONtechnologies
    http://www.devon-technologies.com